.. highlightlang:: us

.. _@f{cursor_value}:

@f{cursor_value}
================

.. index:: @f{cursor_value}

.. us.tag  @f{cursor_value} GERMAN fieldfunction New5100

Displays the x- or y-value of a 2D dataset at the cursor position.

.. function::  @f{cursor_value(dataset_name)}
    @f{cursor_value(dataset_name, iCursor)}
    @f{cursor_value(dataset_name, iCursor, format)}
    @f{cursor_value(dataset_name, iCursor, format, x_or_y)}

.. us.params

**Parameters**

.. uparam:: dataset_name

   *dataset_name* is the dataset name.

.. uparam:: iCursor

   *iCursor* is 1 for the first cursor and 2 for the second cursor.
   Default value is 1.

.. uparam:: format

   *format* specifies the output format. see :ref:`printf`.

.. uparam:: x_or_y

   *x_or_y* is x for the x-value or y for the y value.

.. us.comment

**Comment**

The field function can be added to a table cell or a text object.

The result value will be updates when the cursor is moved. If the cursor
is not displayed the value will not be modified.

.. us.example

**Example**

.. code-block:: none

   @f{cursor_value(Data1, 1, %.3lf)}{9.000}

.. seealso::
   :ref:`overview-field-functions`,
   :ref:`editupdate-fields`,
   :ref:`diagraminsert-field-function`

:sub:`id-728090`